tcl.sp-assign Verb: Access/Spooler

tcl.sp-assign

Command tcl.sp-assign Verb: Access/Spooler
Applicable release versions: AP, AP 6.1, R83
Category Spooler (24)
Description displays, changes or resets the current Spooler output assignment options for the current process/user.

An "sp-assign" command with no options 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.

"sp-assign" with no options also closes any currently open files assigned by the current process.
Syntax sp-assign {options}
Options number.copies (integer number in the range 1-125) indicating 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. (See "assignfq").

a Ouput goes to the alternate port on the current terminal. To function correctly, the auxillary port on and off commands must be defined for the current terminal in the devices file. Note that 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. The "choke" option 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 Indicates the output queue into which a print file is to be inserted. "number" must be between 0 and 125, inclusive. The default output queue is 0. Each output queue is assigned to a specific printer. See "listptr" and "sp-status.

h Spools output to a hold file.

i Spools output to the printer immediately.

m Suppresses the display of "[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. See also the "sp-open" and "sp-close" command. 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 given by 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 Pick/BASIC. 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. "t" 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" verb, if necessary.
Example
sp-assign hs ?
Line#  Status   Copies  Form#  Device
39   hs           1      0  dp.lzr

"Line#" is the port.number to which this terminal is attached.

"Status" is the assignment options set by "sp-assign". 

"Copies" is the number of copies to print

"Form#" is the form queue number(s).

"Device" is the  Printer device name. (See: "assignfq").

sp-assign 13 f11 ? 
Line#  Status   Copies  Form#  Device
39    p          13     11  hp-lzrii
Purpose
Related tcl.sp-close
access.lptr
basic.print.on
spooler.commands
spooler.options
tcl.p.option
port.number
tcl.t-att
tcl.sp-tapeout
tape.label
tcl.sp-open
tcl.listpeqs
runoff.options.p
tcl.sp-edit
tcl.listptr
tcl.sp-status
basic.aux
basic.spoolq
tcl.sp-assign.link
filename.peqs
tcl.pr-spool-job