sp-assign Command

The sp-assign command displays, changes or resets the current spooler output assignment options for the current process/user. An sp-assign command with no options closes any currently open files assigned by the current process and resets the assignment to the default state. The default assignment is: output to printer, normal spooler entry (meaning, not a hold file), one copy, form queue 0, close files at end of process, queue job for output immediately upon closing.

Syntax

sp-assign {options}

Parameter(s)

options	number.copies	(Integer number in the range 1-125.) Indicates the number of copies (default = one).
	?	Outputs resulting setting, or current setting when entered alone. The display shows the process port number, current assignment parameters, and the device assigned to the currently assigned output queue.
	a	Output goes to the alternate port on the current terminal. To function correctly, the auxiliary port on and off commands must be defined for the current terminal in the devices file. NOTE—The a option does not suppress output to the system printer by default. To disable system printer output, use the s option as well.
	c	Chokes output. This stops the process from generating output when it gets 20 frames ahead of the printer. The c option is relevant only with output going to the printer and can only be used with an i option and without an h option. If a printer is not available or assigned to another output queue, the c option causes the process to wait until the printer is available and causes the copy count to go to 1 (one).
	d	Delays sending output to the queue. The output is delayed until the file is closed. This option must not be used with the i option. This option overrides the i option.
	fnumber	Specifies the output queue into which a print file will be inserted. The number must be between 0 and 2047, inclusive. The default output queue is 0. Each output queue is assigned to a specific printer.
	h	Spools output to a hold file.
	i	Spools output to the printer immediately.
	m	Suppress the display of message [1151] Entry # n.
	o	Leaves the entry open. The print file remains open upon completion of the process. This allows placing multiple print jobs in one physical spooler entry. To close the entry, use the sp-assign command without options, or the sp-close command.
	p	Assigns output to the printer. This is the default.
	rnumber	Opens a print file with the specifications of the other options in the string. number can be between 0 and 125 inclusive and is the number used in print on n statements in FlashBASIC. CAUTION—If the r option is used to send two or more print files to tape during the same process, their outputs will be intermingled on the tape. If the r option and the i option are both specified, the printer starts to generate output immediately and does not wait for the print job to be completed before printing. There is no harm in this, except that no other print jobs can be serviced by that printer until the program has completed. sp-assign with the r option can be used to initialize print files until the capacity of the input control block is exhausted. There are about 60 input control block records available, depending on the system configuration.
	s	Suppresses output to printer.
	t	Assigns output to tape and specifies that the print file goes directly to tape under the control of the generating process rather than under the control of the spooler process. Therefore, the tape should be mounted before the job is started. The t option invokes the t-att command, if necessary.

WARNING

Note that options must not be preceded by an open parenthesis as with other commands.

Example(s)

sp-assign hs ?
Line#	Status	Copies	Form#	Device
39	hs	1	0	dp.lzr

Line#	Port number to which this terminal is attached.
Status	Assignment options set by sp-assign.
Copies	Number of copies to print.
Form#	Form queue numbers.
Device	Printer device name. (See assignfq (UNIX) Command).

sp-assign 13 f11 ?
Line#	Status	Copies	Form#	Device
39	9	13	11	dp.lzrii