*WINPRT* / *WINDEV* Queues

Special File Handling

	The queue information in this section applies to both WINDEV and WINPRT device files. The examples illustrate the formats you can use to designate printer queues and assign values to a printer's properties, Q_options (WINPRT only). To select a particular printer, use the actual OS print queue name in your OPEN directive. The Q_name you use must match the print queue's OS name (in the Printers folder of the Control Panel on the local Windows PC, as assigned to the printer when it was installed; e.g., "Bills Desk - Canon". Omit any mention of ports. For instance, if the Control Panel folder records the name as "HP LasertJet on LPT1", simply use HP LaserJet as the queue name in your directive. Examples: In these examples, because the queue is named in the OPEN directive, the end-users will not see the printer selection dialogue at run time. (You can use this to advantage if you want to prevent users from changing the printer and properties during the print run.) OPEN (1)"WINPRT;HP LaserJet" OPEN (2)"WINPRT;Bills Desk - Canon;orientation=landscape;copies=3" OPEN (3)"WINDEV;HP LaserJet;copies=2" ASIS Use the ASIS keyword to OPEN the most recently selected printer with all its settings as is. Again, the users will not have access to the printer selection dialogue at run time and can't alter the settings.

*Warning*	All the settings for the queue options will be identical to the previous selection. For the examples below, the previous selection was the HP LaserJet, copies=2, so the ASIS print jobs below are sent to the HP LaserJet using its current property settings. All properties (including copies=2 ) will be identical.

	Examples: OPEN (1)"WINPRT;ASIS" OPEN (2)"WINDEV;ASIS" For *WINPRT* only —you can override the ASIS queue option settings in your OPEN directive: OPEN (1)"WINPRT;ASIS;copies=5;offset=500:500" OPEN (2)"WINPRT;ASIS;file=hello.txt" (Make sure your properties and values are valid for the given driver.) DEFAULT Use the DEFAULT keyword to OPEN the printer currently "Set As Default". The users will not have access to the printer selection dialogue and can't alter your settings at run time. For *WINPRT* only —you can use queue options to override the current DEFAULT properties. Examples: If the default printer is "Bills Desk - Canon", then the print jobs in the examples below will be sent to that Canon printer: OPEN (1)"WINPRT;DEFAULT" OPEN (2)"WINPRT;DEFAULT;copies=5;orientation=landscape;offset=300:600" OPEN (3)"WINDEV;DEFAULT" NORMAL Use the NORMAL keyword in your OPEN directive when you want the user to see the printer selection dialogue including a page range option (but no paper size or source tray options) at run time. The users can accept the current settings or alter them. The current options (including any options you set for *WINPRT* in your OPEN directive) are displayed in the printer selection dialogue when the user sees it. Example: Note that either OPEN(30)"WINDEV"(omitting the queue name) or OPEN (30)"WINDEV;NORMAL" will display the dialogue box so that the user can make changes. However, a queue name (in this case, NORMAL) is mandatory if you include queue options in a *WINPRT* command; e.g., OPEN (14)"WINPRT;NORMAL;orientation=landscape" SETUP Use the SETUP keyword in your OPEN directive when you want the user to see the printer selection dialogue with paper size and source tray options (without the page range option) at run time. The current options (including any options you set in your OPEN directive for *WINPRT) are displayed in the printer selection dialogue when the user sees it. Examples:* OPEN(1)"WINPRT;SETUP" OPEN(2)"WINDEV;SETUP" OPEN(3)"WINPRT;SETUP;range=1:5"

WINPRT and WINDEV Queue Properties	To retrieve a list of the properties that are valid for a given queue, use WINPRT_SETUP READ PROPERTIES; e.g., ->OPEN INPUT (30)"WINDEV;ASIS" ->WINPRT_SETUP READ PROPERTIES WHAT_PROP$ ->?what_prop$ RANGE=ALL;COLLATE=NO;COPIES=1;ORIENTATION=PORTRAIT;PAPERSIZE=1;SOURCE=1; RESOLUTION=300:300;OFFSET=0:0;TRUETYPE=2;DRIVER=WINSPOOL ->close (30)
	For *WINPRT* only — you can use Q_options in your directive to assign values to the properties the individual driver allows for your given queue. Most Q_options are self-explanatory, like copies=1. For a detailed list of properties, refer to the WINPRT_SETUP Directive. You can obtain information on available fonts for graphics mode printing via PRINT *'FONT'(LIST ). This mnemonic is not for character mode. Refer to the 'FONT'** Mnemonic.

Link Files for Queues	You can use a link file, associating a device or file with a device driver. The device can be any valid device or filename including any of the Windows printers. The device driver is a ProvideX-based program that resides in the DEVdirectory (or /pvx/lib/_dev directory). Link files are maintained with the ProvideX utility UCL (Utilities/Configuration/Linkfiles). The name of the link file can be any valid OS filename; e.g.,
	Link filename:	LP
	Device/filename:	WINDEV;HP Laser Jet
	Device driver:	HPLASER

	The queue information in this section applies to both WINDEV and WINPRT device files. The examples illustrate the formats you can use to designate printer queues and assign values to a printer's properties, Q_options (WINPRT only). To select a particular printer, use the actual OS print queue name in your OPEN directive. The Q_name you use must match the print queue's OS name (in the Printers folder of the Control Panel on the local Windows PC, as assigned to the printer when it was installed; e.g., "Bills Desk - Canon". Omit any mention of ports. For instance, if the Control Panel folder records the name as "HP LasertJet on LPT1", simply use HP LaserJet as the queue name in your directive. Examples: In these examples, because the queue is named in the OPEN directive, the end-users will not see the printer selection dialogue at run time. (You can use this to advantage if you want to prevent users from changing the printer and properties during the print run.) OPEN (1)"WINPRT;HP LaserJet" OPEN (2)"WINPRT;Bills Desk - Canon;orientation=landscape;copies=3" OPEN (3)"WINDEV;HP LaserJet;copies=2" ASIS Use the ASIS keyword to OPEN the most recently selected printer with all its settings as is. Again, the users will not have access to the printer selection dialogue at run time and can't alter the settings.

*Warning*	All the settings for the queue options will be identical to the previous selection. For the examples below, the previous selection was the HP LaserJet, copies=2, so the ASIS print jobs below are sent to the HP LaserJet using its current property settings. All properties (including copies=2 ) will be identical.

	Examples: OPEN (1)"WINPRT;ASIS" OPEN (2)"WINDEV;ASIS" For *WINPRT* only —you can override the ASIS queue option settings in your OPEN directive: OPEN (1)"WINPRT;ASIS;copies=5;offset=500:500" OPEN (2)"WINPRT;ASIS;file=hello.txt" (Make sure your properties and values are valid for the given driver.) DEFAULT Use the DEFAULT keyword to OPEN the printer currently "Set As Default". The users will not have access to the printer selection dialogue and can't alter your settings at run time. For *WINPRT* only —you can use queue options to override the current DEFAULT properties. Examples: If the default printer is "Bills Desk - Canon", then the print jobs in the examples below will be sent to that Canon printer: OPEN (1)"WINPRT;DEFAULT" OPEN (2)"WINPRT;DEFAULT;copies=5;orientation=landscape;offset=300:600" OPEN (3)"WINDEV;DEFAULT" NORMAL Use the NORMAL keyword in your OPEN directive when you want the user to see the printer selection dialogue including a page range option (but no paper size or source tray options) at run time. The users can accept the current settings or alter them. The current options (including any options you set for *WINPRT* in your OPEN directive) are displayed in the printer selection dialogue when the user sees it. Example: Note that either OPEN(30)"WINDEV"(omitting the queue name) or OPEN (30)"WINDEV;NORMAL" will display the dialogue box so that the user can make changes. However, a queue name (in this case, NORMAL) is mandatory if you include queue options in a *WINPRT* command; e.g., OPEN (14)"WINPRT;NORMAL;orientation=landscape" SETUP Use the SETUP keyword in your OPEN directive when you want the user to see the printer selection dialogue with paper size and source tray options (without the page range option) at run time. The current options (including any options you set in your OPEN directive for *WINPRT) are displayed in the printer selection dialogue when the user sees it. Examples:* OPEN(1)"WINPRT;SETUP" OPEN(2)"WINDEV;SETUP" OPEN(3)"WINPRT;SETUP;range=1:5"

WINPRT and WINDEV Queue Properties	To retrieve a list of the properties that are valid for a given queue, use WINPRT_SETUP READ PROPERTIES; e.g., ->OPEN INPUT (30)"WINDEV;ASIS" ->WINPRT_SETUP READ PROPERTIES WHAT_PROP$ ->?what_prop$ RANGE=ALL;COLLATE=NO;COPIES=1;ORIENTATION=PORTRAIT;PAPERSIZE=1;SOURCE=1; RESOLUTION=300:300;OFFSET=0:0;TRUETYPE=2;DRIVER=WINSPOOL ->close (30)
	For *WINPRT* only — you can use Q_options in your directive to assign values to the properties the individual driver allows for your given queue. Most Q_options are self-explanatory, like copies=1. For a detailed list of properties, refer to the WINPRT_SETUP Directive. You can obtain information on available fonts for graphics mode printing via PRINT *'FONT'(LIST ). This mnemonic is not for character mode. Refer to the 'FONT'** Mnemonic.

Link Files for Queues	You can use a link file, associating a device or file with a device driver. The device can be any valid device or filename including any of the Windows printers. The device driver is a ProvideX-based program that resides in the DEVdirectory (or /pvx/lib/_dev directory). Link files are maintained with the ProvideX utility UCL (Utilities/Configuration/Linkfiles). The name of the link file can be any valid OS filename; e.g.,
	Link filename:	LP
	Device/filename:	WINDEV;HP Laser Jet
	Device driver:	HPLASER