Default Configuration for XMLPrintStream

The XMLPrintStream class lets you set a number of options when you want to submit a print job. These are the printer name, the paper tray name, the server host name, and the server port number. Each of these options can be set in your project's properties as described in the Cúram Server Developer's Guide. The values required are shown in the Default Configuration for XMLPrintStream. All are entered as strings and are not converted to any other data-type. You must make sure to convert any special characters with a meaning in XML to character entities.

Table 1. The application prx settings for XMLPrintStream

Variable Name

Description

curam.xmlserver.printer

The name of the default printer to use for jobs submitted by this application. On Microsoft Windows, this might be, for example, \\\\myhost\\printer1, or lpt1:.

curam.xmlserver.tray

The name of the paper tray to use for jobs submitted by this application.

curam.xmlserver.host

The host on which the XML Print Server resides. The property may also be specified as a '/' separated list of host names in order to use multiple XML Servers.

curam.xmlserver.port

The port on which the XML Print Server is listening. The property may also be specified as a '/' separated list of ports in order to use multiple XML Servers.

curam.xmlserver.fileencoding

The default encoding used for the encoding of files provided to the XMLServer. This value can be overriden for individual instances of XMLPrintStream using the setEncoding method. The default value for this property is UTF-8.

curam.xmlserver.serializelocaleneutral

Specify that XML Server data will be serialized in a locale-neutral way instead of being based on the locale properties on the server.

When your application submits a print job, these values will be used as the defaults for the job. You can use the individual setter methods to override these defaults.