SpoolPath: Difference between revisions

From BR Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
The '''SPOOLPATH''' [[BRConfig.sys]]  configuration statement specifies where print spool files are temporarily stored during printing. Specify a full OS pathname:
The '''SPOOLPATH''' [[BRConfig.sys]]  configuration statement specifies where print spool files are temporarily stored during printing. Use it to specify a full OS pathname:


  e.g.  SPOOLPATH  :C:\BR\SPOOL
SPOOLPATH  :C:\BR\SPOOL
        SPOOLPATH  :/br/spool      - Linux or MAC example -
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.
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:
  e.g. DRIVE  J:,C:\BR,x,\MYAPP  with no SPOOLPATH statement would result in spool files being placed in:
  DRIVE  J:,C:\BR,x,\MYAPP   
        C:\BR\SPOOL\
with no SPOOLPATH statement would result in spool files being placed in:
C:\BR\SPOOL\


The status of SPOOLPATH and REMOTESPOOLPATH settings are displayed in response to the STATUS SUBSTITUTE command (not the STATUS CONFIG command).   
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===
===Client SPOOLPATH===
Client SPOOLPATH specifies where on the client spool files are to be placed. This is also where PDF files are created.  
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 statement format is: '''SPOOLPATH @::client-OS-fullpath'''   
  SPOOLPATH  @::C:\BR\SPOOL
  SPOOLPATH  @::C:\BR\SPOOL


The ''''@:''''  tells BR that this path is on the client. The second colon in the example tells the client that this is not a relative pathname.   
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.
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.  
 
STATUS SUBSTITUTE displays the status of SPOOLPATH and REMOTESPOOLPATH. 


The client-pathname has some unique characteristics:
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.  
* 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.  
* 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.
* Specifying a relative remote pathname is not compatible with CLIENT_CURRENT_DIR SYNC.


See also:   
See also:   

Revision as of 18:31, 31 July 2015

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  :C:\BR\SPOOL
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:

C:\BR\SPOOL\

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

SPOOLPATH  @::C:\BR\SPOOL

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: