To execute jobs using a Rhozet Carbon Coder system, Etere uses the Rhozet's command line tool (rzcp.exe) using the syntax below:
<RZCP path> [Options] <XML file>
Options can be specified for "Rhozet RZCP Transcoding" actions in the "command-line options"clickHere text box, thus allowing a more custom execution of jobs. For instance:
"C:\Program Files (x86)\Rhozet\Carbon Coder\rzcp.exe" -queuewait "C:\Users\usrdm1\AppData\Local\Temp\Etere\dm39800.xml"
Here below are listed the options supported by the Rhozet's command-line tool:
Option: queue
Description: Instead of executing the transcoding job internally on the rzp tool, it submits the job to the Rhozet Nexus (carbon coder) service and terminates the rzcp tool immediately.
NB: Etere won't be acquainted with the job result, and the target file may not be found when expected.
Example: -queue
Option: queuewait
Description: Instead of executing the transcoding job internally on the rzp tool, it submits the job to the Rhozet Nexus (carbon coder) service and waits for it to complete before terminating the rzcp tool.
NB: Etere will be acquainted with the job result so the target file will be correctly found in the expected location.
Example: -queuewait
Note
▪The queue and queuewait options cannot be used simultaneously.
▪If the queue or queuewait options is specified, other options (besides -dump and -source) will be ignored as transcoding information will be taken from the XML file specified in the command line.
▪Jobs submitted by queue and queuewait options will be available in the "Carbon Server Admin" under the job tabs (i.e. active, queued, completed, failed), thus allowing to, for example, easily track the errors that avoid a job execution.
Option: source
Description: Local/network path to the source file.
NB: Multiple source files are permitted for direct execution, but only one project file is accepted. All sources will be stitched together to represent one logical source.
Example: -source \\archive1\clips\hr\vois.mxf
Option: target
Description: GUID of the preset to be used for the transcoding.
Example: -target {80F0840E-FE8B-4EFE-83C4-228D8124394D}
Option: targetdir
Description: Target folder on which the transcoded file will be placed.
NB: trailing backslashes are not permitted
Example: -targetdir \\nle3\received\
Option: queuejob
Description: When queuing, specifies the complete job to be queued.
NB: Multiple projects are possible. Projects must be complete, including sources. Preset files (.cpf) can be used to substitute project files.
Example: -queuejob pro1.cpf
Option: dump
Description: The filename of the project file for saving the assembled job or the XML file for saving the queue response.
Example: -dump assjob.xml
Option: remote
Description: Specify the IP or Machine Name of a Carbon Server to execute the job remotely rather than on the local server.
Example: -remote 172.31.230.106
Option: raw
Description: Dump only the pure response to the standard output (stdout).
NB: Use it for piping an XML response into a well-formed XML file.
Example: -raw
Option: noresponse
Description: Do not print queue response XML (e.g. GUID, Success, etc)
Example: -noresponse
Option: prf_ft
Description: Print processing time
Example: -prf_ft
Option: prf_nt
Description: Print raw processing time (without engine init/de-init)
Example: -prf_nt