Click above to get retro games delivered to your door ever month!

You can set a capture queue for each of three local printer ports by 
calling N_CAPSET() and set a default port with N_CAPDFLT(). Obviously 
these functions are more powerful than N_SPLQUE(). Though superseded, 
N_SPLQUE() has been retained in the library to maintain compatibility 
with earlier  versions of NetLib. Future versions may not retain 
N_SPLQUE(), so please take this opportunity to begin using the new 
function in your code.


Syntax

N_SPLQUE( [ <cQueue> ] )


Parameters

<cQueue>
Name of a print queue. The queue name may optionally be prefixed with a 
file server name:



Returns

N_SPLQUE() with no parameters returns the name of the current capture 
queue, if any.

N_SPLQUE(<cQueue>) returns logical true if the specified queue exists.


Description

Directs the network to place subsequent documents on the specified 
queue. All documents subsequently printed by the current station are 
affected until changed by another N_SPLQUE(). Documents already on a 
queue are not affected.

If the queue resides on another server, issue N_SPLSRV() prior to 
N_SPLQUE(), or prefix the name of the server followed by "\" to the 
queue name passed with N_SPLQUE(). If you specify a server with 
N_SPLSRV() and also prefix a server name to the queue name passed with 
N_SPLQUE(), the server name passed with N_SPLQUE() takes precedence.

If LPT1 is not the normal capture device, issue N_CAPDFLT() prior to 
N_SPLQUE().