From BR Wiki
Jump to navigation Jump to search

The SPOOLPATH BRConfig.sys configuration statement specifies where print spool files are temporarily stored during printing. Use it to specify a full OS pathname:

SPOOLPATH  :/br/spool       - Linux or MAC example -

SPOOLPATH defaults to a spool directory that runs off of the BR root of the first drive statement. If no such spool directory exists and SPOOLPATH is not specified then BR creates one. For example:

DRIVE   J:,C:\BR,x,\MYAPP   

with no SPOOLPATH statement would result in spool files being placed in:


The status of SPOOLPATH and REMOTESPOOLPATH settings are displayed in response to the STATUS SUBSTITUTE command (not the STATUS CONFIG command). Instead, STATUS SUBSTITUTE displays the status of SPOOLPATH and REMOTESPOOLPATH.

Client Spoolpath

For client / server configurations, SPOOLPATH @: client-pathname Sets the remote spool path on the client. This is also where PDF files are created.

The statement format is: SPOOLPATH @::client-OS-fullpath


The '@:' tells BR that this path is on the client, or remote. The second colon in the example tells the client that this is not a relative pathname.

SPOOLPATH can be set concurrently for both client and server by specifying two SPOOLPATH statements. BR creates print files in the server spool directory during printing and forwards them to the client when the print file is closed.

The client-pathname has some unique characteristics:

  • Relative paths are assumed to be OS pathnames relative to the CLIENT_CURRENT_DIR folder, or the client startup directory if CLIENT_CURRENT_DIR is not specified.
  • If a full pathname is specified it must begin with a colon. (e.g. @::X:\path ). Otherwise, it will be preceded with the path to the client current working directory.
  • Specifying a relative remote pathname is not compatible with CLIENT_CURRENT_DIR SYNC.

See also: