SET.QUEUE

The SET.QUEUE command creates a relationship between a Pick style form queue number and the corresponding SETPTR print unit options.

Format

SET.QUEUE queue {, width, depth, top.margin, bottom.margin, mode {, options }}

SET.QUEUE DISPLAY {LPTR {unit}}

SET.QUEUE DELETING queue

where

queue

is the form queue number in the range 0 to 999.

width

is the page width in characters, excluding any left margin.

depth

is the total page length in lines, including the top and bottom margins. A value of zero implies no pagination of the output data.

top.margin

is the number of lines to be left blank at the top of the page.

bottom.margin

is the number of lines to be left blank at the bottom of the page.

mode	is the print unit mode.

options

qualify the output destination. The option syntax is the same as in the SETPTR command. There should be a comma between each option.

If only queue is given, the current settings of the form queue are reported.

The SET.QUEUE command creates or modifies an entry in the $FORMS file to relate a Pick style form queue number to the corresponding SETPTR options. This form queue number can then be used in the SP.ASSIGN command. See SETPTR for details of the command options.

The SET.QUEUE DISPLAY command displays a report of the settings of all defined form queues. The optional LPTR keyword directs this report to a printer.

The SET.QUEUE DELETING command deletes a form queue definition.

The $FORMS file is normally shared between all accounts by use of a VOC entry that references the $FORMS file in the QMSYS account. An account can have its own forms definition file by modifying this VOC entry to point to a file within the account. It is also possible for users to have a personal forms definition file based on their login id by setting the pathname to be of the form

@HOME\FORMS

where the @HOME element will be replaced by the user's home directory pathname.

SET.QUEUE performs limited validation of the parameters as later use of SP.ASSIGN may change some of them. For example, it is valid for a SET.QUEUE command to have both the AS and AT options (see SETPTR). Whichever is not applicable to the mode settings when the SP.ASSIGN command is used will be discarded.

If then $SETPTR.DEFAULTS record exists (see SETPTR), the default options are applied at the point when the SP.ASSIGN command is used.

Examples

SET.QUEUE 0,80,66,3,3,1,AT laser

Directs form queue 0 output to a printer named "laser" with a page shape of 80 columns by 66 lines and a 3 line top and bottom margin.

SET.QUEUE 4,80,66,0,0,3,AS SALES_REPORT

Directs form queue 4 output to a record named "SALES_REPORT" in the $HOLD file.