Specifying File Names in Symbol Notation

For example, when you create a Passthrough printer, you need to specify the command that submits jobs to the printer device. This command has to specify the name of the print file, which is different for each job. Use the getFileName or getAbsoluteFileName methods to return the name of the print file. As an option, you can specify a command that prints special instructions on a separator sheet before the job is printed. Use the getOperInst method to return the name of the file that contains the special instructions.

getFileName and getAbsoluteFileName Syntax

Use the getFileName and getAbsoluteFileName methods to return the name of a specific print file. The difference between the two methods is that getAbsoluteFileName fails if a file of the requested data type or types does not exist, but getFileName continues to search. If it finds a print file of data type unknown, it returns the name of that file.

Use one of these syntaxes:

• To search for a print file when you know the data type:

  ${getFileName(print,Datatype,read)}
  ${getAbsoluteFileName(print,Datatype,read)}

• To search for a print file when the data type might be one of several data types:

  ${getFileName(print,(Datatype1,Datatype2...),read)}
  ${getAbsoluteFileName(print,(Datatype1,Datatype2...),read)}

where:

print

This keyword specifies that you are searching for a printable file.

Datatype or (Datatype1, Datatype2...)

These keywords specify the datatype of the file that you want to find. Values for Datatype are:

pcl
pdf
ps
tiff
png
jpeg
unknown	Use unknown for any datatype that does not have a keyword.

read

This keyword specifies that the print command reads the job file from the print spool.

getOperInst Syntax

The getOperInst method to return the name of a file that contains printable special instructions.

Use this syntax to search for a special instructions file:

${getOperInst(pdf)}