Primera PTBurn SDK User manual

PTBurn SDK
Network-capable, text-based, shared folder burning &
Printing
Primera Technology Inc.

PTBurn SDK Page 2 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.
May 4, 2006 / Revision 2.61

PTBurn SDK Page 3 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.
1 Introduction............................................................................................................................. 6
2 JRQ File Command Structure................................................................................................. 7
2.1 Command Keys/Values .................................................................................................. 7
2.1.1 JobID....................................................................................................................... 7
2.1.2 ClientID................................................................................................................... 7
2.1.3 Importance .............................................................................................................. 7
2.1.4 DiscType................................................................................................................. 7
2.1.5 Data......................................................................................................................... 7
2.1.6 AudioFile ................................................................................................................ 8
2.1.7 ImageFile ................................................................................................................ 8
2.1.8 DeleteFiles .............................................................................................................. 9
2.1.9 ImageType .............................................................................................................. 9
2.1.10 DataImageType..................................................................................................... 10
2.1.11 CloseDisc.............................................................................................................. 10
2.1.12 Copies ................................................................................................................... 10
2.1.13 PrintLabel.............................................................................................................. 11
2.1.14 VolumeName........................................................................................................ 11
2.1.15 BurnSpeed............................................................................................................. 11
2.1.16 VerifyDisc............................................................................................................. 11
2.1.17 RejectIfNotBlank.................................................................................................. 11
2.1.18 NotifyClient .......................................................................................................... 11
2.1.19 CDTextDiscTitle................................................................................................... 12
2.1.20 CDTextDiscPerformer.......................................................................................... 12
2.1.21 CDTextDiscComposer.......................................................................................... 12
2.1.22 CDTextTrackTitle................................................................................................. 12
2.1.23 CDTextTrackPerformer........................................................................................ 12
2.1.24 CDTextTrackComposer........................................................................................ 12
2.1.25 PreserveISOVariations.......................................................................................... 12
2.1.26 ReadDataTo .......................................................................................................... 13
2.1.27 ReadDataFormat................................................................................................... 13
2.1.28 CreateSubFolders.................................................................................................. 13
2.1.29 CheckFileOnDisc.................................................................................................. 13
2.1.30 CheckSystemIDOnDisc........................................................................................ 13
2.1.31 CheckVolumeIDOnDisc....................................................................................... 14
2.1.32 CheckPubIDOnDisc.............................................................................................. 14
2.1.33 CheckPreparerIDOnDisc ...................................................................................... 14
2.1.34 CheckAppIDOnDisc............................................................................................. 14
2.1.35 PVDSystemID....................................................................................................... 14
2.1.36 PVDPublisherID................................................................................................... 14
2.1.37 PVDPreparerID..................................................................................................... 14
2.1.38 PVDApplicationID ............................................................................................... 14
2.1.39 LoadUnloadOverride ............................................................................................ 14
2.1.40 PreMasterData....................................................................................................... 15
2.1.41 DriveID................................................................................................................. 15
2.2 Programming Examples................................................................................................ 15
2.2.1 Simple Data Job.................................................................................................... 15
2.2.2 Simple Audio Job.................................................................................................. 15
2.2.3 Burn and Print job of 5 discs with many options specified .................................. 16

PTBurn SDK Page 4 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.2.4 Print Only Job of 25 Discs.................................................................................... 16
2.2.5 Read Data Job of 3 Discs...................................................................................... 16
2.2.6 Read Global Image Job of 3 Discs........................................................................ 17
3 Status Information................................................................................................................. 18
3.1 JobList Section.............................................................................................................. 18
3.2 CompletedJobs Section................................................................................................. 18
3.3 Job Details Section........................................................................................................ 19
3.3.1 JobID..................................................................................................................... 19
3.3.2 ClientID................................................................................................................. 19
3.3.3 JobsAhead............................................................................................................. 19
3.3.4 DiscsAhead........................................................................................................... 19
3.3.5 DiscsRemaining.................................................................................................... 19
3.3.6 GoodDiscs............................................................................................................. 19
3.3.7 BadDiscs............................................................................................................... 19
3.3.8 CurrentStatus......................................................................................................... 19
3.3.9 TimeCreated.......................................................................................................... 20
3.3.10 TimeStarted........................................................................................................... 20
3.3.11 TimeCompleted..................................................................................................... 20
3.3.12 JobState................................................................................................................. 20
3.3.13 JobErrorNumber ................................................................................................... 20
3.3.14 JobErrorString....................................................................................................... 20
3.3.15 DiscErrorIndexX................................................................................................... 20
3.3.16 DiscErrorNumberX............................................................................................... 21
3.3.17 DiscErrorStringX.................................................................................................. 21
3.3.18 LoadDiscStateX.................................................................................................... 21
3.3.19 LoadDiscDriveX................................................................................................... 22
3.4 System Section.............................................................................................................. 22
3.4.1 SystemDesc........................................................................................................... 22
3.4.2 SystemStatus......................................................................................................... 22
3.4.3 SystemDrives........................................................................................................ 22
3.4.4 GoodDiscsLife...................................................................................................... 22
3.4.5 BadDiscsLife......................................................................................................... 22
3.4.6 GoodDiscsLaunch................................................................................................. 22
3.4.7 BadDiscsLaunch................................................................................................... 22
3.4.8 ServerTime............................................................................................................ 22
3.4.9 DriveSpace............................................................................................................ 23
3.4.10 SysErrorNumber................................................................................................... 23
3.4.11 SysErrorString....................................................................................................... 23
3.4.12 PtburnSWVer........................................................................................................ 23
3.4.13 JobProcSWVer...................................................................................................... 23
3.4.14 PxroboSWVer....................................................................................................... 23
3.4.15 PxengSWVer......................................................................................................... 23
3.4.16 PxsdkSWVer......................................................................................................... 23
3.4.17 PxDrvSWVer........................................................................................................ 23
3.4.18 PxMasSWVer ....................................................................................................... 23
3.4.19 PxWaveSWVer..................................................................................................... 23
3.4.20 PxHelp20SWVer................................................................................................... 24
3.4.21 RoboFWVer.......................................................................................................... 24
3.4.22 DriveDescX........................................................................................................... 24

PTBurn SDK Page 5 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.4.23 DriveLocationX .................................................................................................... 24
3.4.24 DriveStateX........................................................................................................... 24
3.4.25 DrivePercentX....................................................................................................... 24
3.4.26 DriveJobX............................................................................................................. 24
3.4.27 DriveDiscX........................................................................................................... 25
3.4.28 DiscsInRightBin.................................................................................................... 25
3.4.29 DiscsInLeftBin...................................................................................................... 25
3.5 Drive Statistics Section................................................................................................. 26
3.5.1 GoodDiscs............................................................................................................. 26
3.5.2 BadDiscs............................................................................................................... 26
3.5.3 ReadingErrors....................................................................................................... 26
3.5.4 ReadingErrorsMedia............................................................................................. 26
3.5.5 RecordingErrors.................................................................................................... 26
3.5.6 RecordingErrorsMedia.......................................................................................... 26
3.5.7 VerifyingErrors..................................................................................................... 26
3.5.8 VerifyingErrorsMedia........................................................................................... 26
3.5.9 DriveNotReady..................................................................................................... 26
3.6 Example of PTStatus.txt ............................................................................................... 26
4 Client Commands.................................................................................................................. 30
4.1 Abort Command............................................................................................................ 30
4.2 Shutdown After Job Command..................................................................................... 30
4.3 Shutdown Immediate Command................................................................................... 30
4.4 Align Printer Command................................................................................................ 31
4.5 Ignore Ink Low Command............................................................................................ 31
4.6 Process Disc Command ................................................................................................ 31
4.7 Reject Disc Command .................................................................................................. 31
4.8 Unload Command......................................................................................................... 32
4.9 Check Bins Command .................................................................................................. 32
5 Appendix A: PTSetup.ini..................................................................................................... 34
6 Appendix B: Deployment Details........................................................................................ 39
7 Appendix C: Job and System Error Codes .......................................................................... 41
8 Appendix D: Loading/Unloading Override......................................................................... 50
9 Revision History ................................................................................................................... 52

PTBurn SDK Page 6 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.
1 Introduction
Primera’s PTBurn SDK application allows any client application to easily create discs with
customized burn data and printed label information. It is ideal for use with customer-supplied
“front-end” applications in networked or custom environments in markets such as medical
imaging, digital photo processing, music/video/software on-demand and much more. The
supported devices for this application are Primera’s Disc Publisher, Disc Publisher II, Disc
Publisher PRO, ComposerMAX, Disc Publisher XR, and Disc PublisherXRP.
The client application creates an ASCII text file (Job Request File) in the Job Request Folder
(shared “hot-folder”). The Job Request File specifies the image data to burn, the label to print,
and the number of copies to create. The PTBurn application scans this Job Request Folder for
new jobs submitted by any client application and creates the discs automatically on the Disc
Publisher.
The application works on Windows 2000 or Windows XP PRO. Client machines can be any that
are able to share and write into a Windows folder. It can burn either data or audio discs, as well
as create discs from a disc image.
Changes can be made to the PTSETUP.INI file to customize certain settings. See Appendix A
for more details on the PTSETUP.INI file
PT Burn Supports the Disc Publisher, Disc Publisher II, the Disc Publisher PRO, ComposerMAX, Disc Publisher XR and Disc
Publisher XRP.

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 0to 9where 0is most important
and 9is least important. If this key is not provided then a default value of 4will 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.

PTBurn SDK Page 8 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.
e.g.
Data = C:\MyFolder1, Session2
(This tells PTBurn to burn the contents of C:\MyFolder1 to session 2 on the disc. In this
example, there must also be an AudioFile= or ImageFile= entry for Session 1).
Up to 99 Data, AudioFile, and ImageFile entries are allowed (99 total).
See the DataImageType key below to specify burning options including file system.
The only way the Data key can be used with the AudioFile keys or the ImageFile key is if
the SessionX value is used. The Data key must not be used with AudioFile or ImageFile
with the same session value.
2.1.6 AudioFile
This is a string that specifies the name of an audio file to burn.
You can optionally specify a Pregap value (in sectors) of the track. So, the format is as follows:
AudioFile = Filename, PregapX, SessionX
Up to 99 AudioFile = statements are allowed (99 total if Data and ImageFile statements used
also).
Acceptable audio filename types include .WAV, .MP3, and .WMA.
PregapX (audio silence) values are in sectors so 75 sectors = 1 second, 150 sectors = 2 seconds,
and so on. The first audio track
will always have a Pregap of 150 even if another value is specified. If Pregap is not specified
then a value of 150 will be used as the default.
SessionX is optional and is used only if requesting a multi-session disc (a maximum of 2
sessions are allowed at this time). The value X is an integer value (1 or 2) and tells PTBurn for
which session to burn this audio file. If SessionX is not given then it will be burned into the first
(and only) session
e.g.
AudioFile = MySong.mp3, Session1
(This tells PTBurn to burn the audio file MySong.mp3 to session 1 on the disc as cd audio. In
this example there may be a Data= or ImageFile= entry for Session 2).
The only way this key can be used with the Data keys or the ImageFile key is if the
SessionX value is used. AudioFile must not be used with Data or ImageFile with the same
session value.
2.1.7 ImageFile
This specifies the name (including path) of an already-mastered disc image to be burned. The
acceptable disc image types include .GI or .ISO.

PTBurn SDK Page 9 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.
The format is as follows:
ImageFile = Filename, SessionX
Where SessionX is optional and is used only if requesting a multi-session disc (a maximum of 2
sessions are allowed at this time). The value X is an integer value (1 or 2) that tells PTBurn
for which session to burn this image.
If SessionX is not given then it will be burned into the first (and only) session.
e.g.
ImageFile = c:\MyImage.ISO, Session1
(This tells PTBurn to burn the disc image MyImage.ISO to session 1 on the disc. In this
example, there may be Data= or AudioFile= entries for Session 2).
The only way this key can be used with the Data keys or the AudioFile keys is if the multi-
session SessionX value is used. ImageFile must not be used with Data or AudioFile keys with
the same session value.
2.1.8 DeleteFiles
This specifies if the files/folders/image for this particular job, should be deleted after the job is
completed. Possible values:
YES
NO
The default value if this key is not given is NO. In order for the files/folders to be deleted they
must reside within a subfolder of the Shared Job Folder. Everything within the first subfolder
under the Shared Job Folder (including the subfolder) will be deleted.
If DeleteFiles is set to YES, the job data and print files will be deleted upon the job completing
(Pass, Fail, or Abort). The job request file (now with a .don or .err extension) will not be deleted
immediately. The deletion of this file will occur when the time set in PTSETUP.ini
(Status_Time) has expired after job completion.
2.1.9 ImageType
This specifies the mode (block length) to use when burning the ImageFile disc image. The
possible values are as follows:
MODE_1_2048
MODE_2_2336
MODE_2_2352
This key only applies to .ISO disc images.
Note that using the wrong value here can cause the image to not fit and lead to an unusable disc.

PTBurn SDK Page 10 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.1.10 DataImageType
This specifies what kind of image should be created for a data burn (when DataFiles key is
given). Multiple items are possible so the format is:
DataImageType = FileSystem, Option1, Option 2, …
Possible values of FileSystem are the following:
ISOLEVEL1 – for an ISO 9660 Level 1 compliant CD with folder and file names in the 8+3
format using only the A-:-Z, 0-:-9 and “_” character set.
ISOLEVEL2 – for and ISO 9660 Level 2 compliant CD (DOS OEM characters). Filenames are
8+3 format (use ISOLEVEL3 for long filename support).
ISOLEVEL3 – for an ISO 9660 Level 3 compliant CD (DOS OEM characters, long file names)
JOLIET – for a Microsoft Joliet compliant CD with filenames up to 106 characters.
ISOLEVEL1+JOLIET – for an ISO 9660 Level 1 with Joliet CD.
ISOLEVEL2+JOLIET – for an ISO 9660 Level 2 with Joliet CD.
ISOLEVEL3+JOLIET – for an ISO 9660 Level 3 with Joliet CD.
UDF – for a UDF 1.02 bridge file system
UDF201 – for a UDF 2.01 bridge file system
Possible values of Option1, Option2, … are the following: SETNOW – this will cause all files
to be set to the time/date at which the disc is created. If this option is not given then the file’s
time/date will keep their original values.
MODE2 – this will make a CD-ROM Mode 2 XA disc. If this option is not given then the disc
created will be Mode 1.
This option is valid only for a CD-R, and is ignored for a DVD-R.
SAO -- if the disc must be written Session At Once. When SAO is not specified the recording is
done Track At Once (TAO). TAO is required for DVD multi-border (DVD-R, DVD-RW) but is
optional for CD-R, CD-RW.
(If this key is not provided, the default will be a Joliet, Mode1, Track at Once Disc).
Note: If choosing ISOLevel1 the filenames must adhere to the ISOLevel1 naming convention
(8+3 using A-Z, 0-9, and _ only). If any files/folders in the job do not adhere to this convention
the job will fail.
Note: If burning DVD Video (VIDEO_TS), we recommend that you select UDF to allow for
better playback compatibility with dvd players.
2.1.11 CloseDisc
This specifies if the disc must be closed so that no other session can be added. Possible values:
YES
NO
The default value is NO if this key is not given.
2.1.12 Copies
This specifies how many copies you want created. The range of values is from 1to 10,000. The
default is 1if this key is not given.

PTBurn SDK Page 11 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.1.13 PrintLabel
This specifies path and filename of the label to print on disc.
The possible file types are .STD (SureThing™), .jpg (JPEG), .bmp (Windows Bitmap), or .PRN
(printed to file through any application). If this key is not given then no printing will be
performed. For printing merge text and pictures (unique text and/or pictures on each disc) see
the supporting SureThing documentation from Microvision (some tips are also given below).
2.1.14 VolumeName
This string specifies the volume label name. The string can be up to 32 characters, but usually
only the first 11 characters are visible on a system. If this key is not given then the default will
be the JobID string (if the JobID string is not given then the default will be “NewDisc”)
2.1.15 BurnSpeed
This integer value specifies a requested recorder burn speed. The range is from 1to 100. This
corresponds to 1x to 100x (even though 100x recorders are currently not available). If this key is
not given then the recorder will burn at MAX speed (or you can set BurnSpeed=0 for MAX
speed). If the recorder is not capable of the requested burn speed, then the nearest available
speed will be used.
2.1.16 VerifyDisc
This specifies if the disc must be verified or not. Possible values:
YES
NO
The default value is NO if this key is not given.
2.1.17 RejectIfNotBlank
This specifies if a disc should be rejected if is not blank. Possible values:
YES
NO
The default value is NO if this key is not given. When a value if YES is given then the disc will
be rejected unless blank media is inserted. NO means that it will attempt to add a session if one
already exists.
2.1.18 NotifyClient
This key specifies if the client wants to be notified when their job is complete (pass, fail, or
abort).
Possible values:
Message
Disabled
The default value is Disabled if this key is not given. When a value of Message is given then
the client will be notified via a net message. If this feature is used, the ClientID key must be set
to the client’s computer name.

PTBurn SDK Page 12 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.1.19 CDTextDiscTitle
This key specifies the CDText field representing the disc’s title. This entry is required when
doing an audio disc with CD Text. The maximum number of characters is 100.
The total number of characters for CDTextDiscTitle and all CDTextTrackTitle entries cannot
exceed 2000 characters
2.1.20 CDTextDiscPerformer
This key specifies the CDText field representing the disc’s performer. This entry is required
when doing an audio disc with CD Text. The maximum number of characters is 100.
The total number of characters for CDTextDiscPerformer and all CDTextTrackPerformer entries
cannot exceed 2000 characters.
2.1.21 CDTextDiscComposer
This key specifies the CDText field representing the disc’s composer. This entry is required
when doing an audio disc with CD Text. The maximum number of characters is 100.
The total number of characters for CDTextDiscComposer and all CDTextTrackComposer entries
cannot exceed 2000 characters.
2.1.22 CDTextTrackTitle
This key specifies the CDText field representing the track’s title. This entry is required for each
track when doing an audio disc with CD Text. The maximum number of characters is 100. The
CDText fields will be associated with their respective track based on the order it appears in the
Job Request File. For example:
AudioFile=myfile1.mp3
AudioFile=myfile2.mp3
CDTextTrackTitle = First track
CDTextTrackTitle = Second track
Track 1 will be myfile1.mp3 with the cdtext “First track”. Track 2 will be myfile2.mp3 with the
cdtext “Second track”.
2.1.23 CDTextTrackPerformer
This key specifies the CDText field representing the track’s performer. This entry is required for
each track when doing an audio disc with CD Text. The maximum number of characters is 100.
2.1.24 CDTextTrackComposer
This key specifies the CDText field representing the track’s composer. This entry is required for
each track when doing an audio disc with CD Text. The maximum number of characters is 100.
2.1.25 PreserveISOVariations
This key forces the recording engine to preserve the file name as is even if it is out of
specification. Possible values:
YES

PTBurn SDK Page 13 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.
NO
The default value is NO if this key is not given.
2.1.26 ReadDataTo
This key specifies the location to which data from the disc(s) should be stored (this is useful for
saving the contents of a disc for later use). If the ReadDataFormat key is set to ReadData, then
this key contains the path of where the data from the disc should be written to the hard disk
drive (ex. C:\MyDisc1). If ReadDataFormat is ReadGI, then ReadDataTo specifies the path and
GI file name that should be created (ex. \\Computer\PTBurnJobs\ReadFile would create the
global image file \\Computer\PTBurnJobs\ReadFile.gi ). When using ReadGI as the format you
should NOT specify the .gi extension in the ReadDataTo key because PTBurn will append the .gi
extension to the name.
2.1.27 ReadDataFormat
This key specifies the format in which the disc(s) will be stored onto the hard disk drive (into the
location specified by ReadDataTo). The possible values are as follows:
ReadGI
ReadData
The default value is ReadData, which will read the data from the disc and store the same data
onto the hard disk drive. ReadGI will create a Global Image file of the Disc. If the format is
ReadGI and the number of copies is greater than 1, then a _1, _2… will be appended to the GI
filename.
2.1.28 CreateSubFolders
This key will cause PTBurn to create a subfolder below the ReadDataTo path for each disc read.
The subfolders will be named Disc1, Disc2 … The possible values are:
YES
NO
The default value is NO if this key is not given. This key is only valid if ReadDataTo is
specified, ReadDataFormat = ReadData, and the number of copies is greater than 1.
2.1.29 CheckFileOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the specified file exists.
The value of this key should be the complete path (on the disc) of the file. For example:
CheckFileOnDisc=Server\myFile.txt
will cause PTBurn to check to see if the file “myFile.txt” is on the disc in the “Server” folder. If
the file is not found then an Invalid Media Error (Job/Disc Error 10) will be set.
2.1.30 CheckSystemIDOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the SystemID value in
the PVD matches the value of this key.
CheckSystemIDOnDisc=PTBurn

PTBurn SDK Page 14 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.
will cause PTBurn to check to see if the system ID in the PVD on the disc is set to “PTBurn” .
If the value is not found then an Invalid Media Error (Job/Disc Error 10) will be set.
2.1.31 CheckVolumeIDOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the VolumeID value in
the PVD matches the value of this key.
If the value is not found then an Invalid Media Error (Job/Disc Error 10) will be set
2.1.32 CheckPubIDOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the PublisherID value in
the PVD matches the value of this key.
If the value is not found then an Invalid Media Error (Job/Disc Error 10) will be set.
2.1.33 CheckPreparerIDOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the DataPreparerID
value in the PVD matches the value of this key.
If the value is not found then an Invalid Media Error (Job/Disc Error 10) will be set.
2.1.34 CheckAppIDOnDisc
This key will cause PTBurn to check the disc prior to recording to see if the ApplicationID value
in the PVD matches the value of this key.
If the value is not found then an Invalid Media Error (Job/Disc Error 10) will be set.
2.1.35 PVDSystemID
This key will set the SystemID value of the PVD. This max number of characters for this key is
32.
2.1.36 PVDPublisherID
This key will set the PublisherID value of the PVD. This max number of characters for this key
is 128.
2.1.37 PVDPreparerID
This key will set the PreparerID value of the PVD. This max number of characters for this key
is 128.
2.1.38 PVDApplicationID
This key will set the ApplicationID value of the PVD. This max number of characters for this
key is 128.
2.1.39 LoadUnloadOverride
This key will enable the manual load and unload functionality.
YES

PTBurn SDK Page 15 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.
NO
The default value is NO if this key is not given. This key allows you to Pause after the drive is
loaded (before burning) and also allows you to Pause after burning (before the drive is
unloaded). It also allows you to Load/Unload the drive without burning (e.g. read disc contents
only).
Please see Appendix D for details regarding manual load and unload.
2.1.40 PreMasterData
This key will enable pre-mastering of data jobs. This means that when the job is started a
temporary image will be created and then each disc in the job will be burned from that image.
Otherwise each disc will be burned as a separate data disc. We recommend setting this to YES if
you are burning a large number of files, or there is the possibility that a file could change during
the burn process.
YES
NO
The default value is NO if this key is not given.
2.1.41 DriveID
This Key is used to specify a drive to be used in a job. There can be more than one DriveID key
in a jrq file. The DriveID should be set to the drive index, which can be found in the
PTStatus.txt file (See DriveDescX in Section 3.4.22). If no DriveID is specified then all drives
in the robot will be used. For Example:
If the JRQ Specifies
DriveID = 0
And the PTStatus.txt has the following entry
DriveDesc0=HL-DT-ST CD-RW GCE-8526B 1.02
DriveLocation0=Publisher Drive Top (G:)
Then, in this example, only the top drive will be used in the job.
2.2 Programming Examples
2.2.1 Simple Data Job
Test1. JRQ in the Job Request Folder has the contents:
Data = c:\MyBackup
This will burn one CD-R disc with all the files and subfolders within the c:\MyBackup folder. It
will be a Joliet file system, Mode 1, Track-at-once, not-closed disc (see other defaults above).
2.2.2 Simple Audio Job
Test2. JRQ in the Job Request Folder has the contents:
AudioFile = c:\MyMusic\MyTrack1.wav
AudioFile = c:\MyMusic\MyTrack2.mp3, Pregap75
AudioFile = c:\MyMusic\MyTrack3.wma, Pregap150

PTBurn SDK Page 16 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.
BurnSpeed = 8
CloseDisc = YES
Copies = 2
This will burn 2 CD-R audio discs with three tracks. The .wav, .mp3, and .wma will be
converted and burned as CD-Audio automatically. MyTrack2 will have a 1 second pause before
it and MyTrack3 will have a 2 second pause before it. The discs will be burned at 8x (or as
close as possible) and the disc will be closed.
2.2.3 Burn and Print job of 5 discs with many options specified
Test3. JRQ in the shared-folder location have the contents:
JobID = Kevin’s Photos
ClientID = COMPANYX-KEVIN1
Data = \\SERVER\PTBurnJobs\KevinsJob\Photos\Data
Data = c:\MyBackup\File1.jpg
DeleteFiles = YES
DataImageType = ISOLEVEL1, SAO, SETNOW
CloseDisc = YES
Copies = 5
PrintLabel = \\SERVER\PTBurnJobs\KevinsJob\Print\Photos.std
VolumeName = My Photos
VerifyDisc = YES
NotifyClient = Message
This will burn 5 CD-R discs with all the files and subfolders within the subfolder
1\\SERVER\PTBurnJobs\KevinsJob\Photos\Data and it will also burn the file
C:\MyBackup\File1.jpg. The disc will be verified after burning. The SureThing label file
\\SERVER\PTBurnJobs\KevinsJob\Print\Photos.std will be printed on each disc. The discs will
be closed-session Disc-at-once with ISO 9660 Level 1 file system, and the time/date of the files
will be set to the time at which each disc is burned. After completing the job, PTBurn will delete
all the files and subfolders within and including the subfolder
\\SERVER\PTBurnJobs\KevinsJob. Note that the file C:\MyBackup\File1.jpg will not be
deleted.
Because the NotifyClient key is set to Message, when the job is completed a net message will be
sent to the computer COMPANYX-KEVIN1.
2.2.4 Print Only Job of 25 Discs
JobID = My Print Job
ClientID = MyWorkstation
PrintLabel = \\SERVER\PTBurnJobs\MyJob\MyImage.STD
Copies = 25
2.2.5 Read Data Job of 3 Discs
ClientID=MyComputer
JobID=Job0
Importance=2
Copies=3
NotifyClient=Message

PTBurn SDK Page 17 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.
ReadDataTo=\\MyComputer\PTBurnJobs\ReadData
ReadDataFormat=ReadData
CreateSubFolders=YES
2.2.6 Read Global Image Job of 3 Discs
ClientID=MyComputer
JobID=Job0
Importance=2
Copies=3
NotifyClient=Message
ReadDataTo=\\MyComputer\PTBurnJobs\ReadData
ReadDataFormat=ReadGI
This will create a GI global image file for each of the 3 discs at the following locations:
\\MyComputer\PTBurnJobs\ReadData_1.gi
\\MyComputer\PTBurnJobs\ReadData_2.gi
\\MyComputer\PTBurnJobs\ReadData_3.gi

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:

PTBurn SDK Page 19 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.
[CompletedJobs]
Job0=MyJob3
Job1=YourJob4
Job2=MyJob5
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.3 Job Details Section
More detailed information about each job in [JobList] and [CompletedJobs] can be accessed in
the job’s own Section.
For example, if a submitted job is called MyJob1.jrq, then the section in the status file would be
given as [MyJob1].
The keys under each job’s details section are:
3.3.1 JobID
String that the describes this job
3.3.2 ClientID
String that describes the client of this job
3.3.3 JobsAhead
Integer value that tells how many jobs are in the PTBurn queue before this job.
3.3.4 DiscsAhead
This integer value tells how many discs remain to be completed (in other jobs) before this job
can begin.
3.3.5 DiscsRemaining
Integer value that tells how many discs are remaining to be completed in this job.
3.3.6 GoodDiscs
Integer value that tells how many discs have been successfully completed in this job
3.3.7 BadDiscs
Integer value that tells how many discs that have failed to be completed successfully in this job
(rejects)
3.3.8 CurrentStatus
String that describes what is currently going on with this job.

PTBurn SDK Page 20 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.3.9 TimeCreated
String that gives the time and date of when the Job Request File was created
Format is:
MM/DD/YYYY hh:mm:ss XX
where XX is either AM or PM.
3.3.10 TimeStarted
String that gives the time and date of when the job was started.
Format is:
MM/DD/YYYY hh:mm:ss XX
where XX is either AM or PM.
If not started yet the value is blank space
3.3.11 TimeCompleted
String that gives the time and date of when the job was completed.
Format is:
MM/DD/YYYY hh:mm:ss XX
where XX is either AM or PM.
If not completed yet the value is blank space
3.3.12 JobState
Integer values that give the state of the job:
0 = Job not started
1 = Job running
2 = Job completed successfully
3 = Job failed
3.3.13 JobErrorNumber
Integer value that details what job error has occurred. Please see Appendix C for details on job
errors.
3.3.14 JobErrorString
String corresponding to the JobErrorNumber. Please see Appendix C for details on job errors.
3.3.15 DiscErrorIndexX
Integer value that details which disc in the job had the error. In other words, the disc number
within the job that the software is attempting to record (e.g. the first disc of the job = 1, second
disc of the job = 2, etc.).