
PTBurnSDK Page38of68
©2011PrimeraTechnology,Inc.PrimeraisaregisteredtrademarkandBravoisatrademarkofPrimeraTechnology,Inc.Allothertrademarks
arethepropertyoftheirrespectivecompanies.
4 ClientCommands
PTBurnclientscansendcommandstothePTBurnserver.
Todothis,theclientshouldcreateanewfileintheJobRequestSharedFolderwiththe
filenameextensionof.PTMwiththesamefilenameastheJRQfileyouarereferencing.
4.1 AbortCommand
Theabortcommandwillabortaparticularjob.The.ptmfilemusthavethesamefilenameas
anexistingJobRequestFileandthevalidcontentsareshownbelow(notethefilenamesmust
matchexceptforthefilenameextensions).
Message=ABORT
ClientID=XXX
WhereXXXisthe
sameClientIDthatisspecifiedinthecorrespondingJobRequestFile.Youcan
abortanyjobbyspecifying“Administrator”fortheClientID.
Forexample,iftheclientsubmitsajobwiththeJobRequestFilenameof:
MyJob1.JRQ
andthentheclientdecidesthatthisjobshouldbeaborted,theclientmustcreateanewfile
called:
MyJob1.PTM
NotethattheClientIDmustbespecifiedanditMUSTmatchtheClientIDinthecorresponding
JobRequestFile–theabortrequestwillberejectediftheClientIDdoesnotmatch.
FortheMyJob1example(seeabove)thecontentsofMyJob1.PTMwouldbe:
Message=ABORT
ClientID=Kevin
4.2 ShutdownAfterJobCommand
The“ShutdownAfterJob”commandwillshutdowntheServersoftwareafteranyin‐process
jobsarecompleted(havea.inpextension).Thiscommandwillpreventanynewjobsfrom
beingputintoan“inprocess”state.Theunitwillfinishallactionsonthe“inprocess”jobsand
thenshutdown.The
.ptmfilecanhaveanynameandshouldbeformattedasfollows:
Message=SHUTDOWN_AFTERJOB
ClientID=Administrator
TheClientIDshouldALWAYSbefixedto“Administrator”.
4.3 ShutdownImmediateCommand
The“ShutdownImmediate”commandwillshutdowntheServersoftwareimmediatelyafterthe
messageisprocessed.Messagesareprocessedapproximatelyevery10seconds.Itisonly
advisedtousethismessageinanemergency.Uponusingthiscommandthesystemwillbeleft
Kommentare zu diesen Handbüchern