STOP-PRINTER-OUTPUT

Cancel printer assignment

Component:	SPOOL
Functional area:	Controlling spoolout job
Domain:	SPOOL-PRINT-ADMINISTRATION
Privileges:	STD-PROCESSING OPERATING PRINT-SERVICE-ADMINISTRATION SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Routing code:	S

Function

The STOP-PRINTER-OUTPUT command cancels the assignment of printers. Nonprivileged users (STD-PROCESSING) can issue the command only when acting as RSO device administrators. The specified printer will cease to be available once any spoolout job currently running on it has been completed. Print jobs scheduled for printing only on the specified device (as specified in the PRINT-DOCUMENT command, for example) are maintained in a job queue and are not printed until the device administrator responsible for the device assigns it again for these jobs.
The administration parameters of a device which has already been assigned can be changed with the MODIFY-PRINTER-OUTPUT-STATUS command.

Starting with BS2000 OSD/BC V11.0, printers that are connectable to the channel are no longer supported. However, print jobs for “local” printers defined in SPOOL are still accepted and can be forwarded to real, LAN-connected high performance printers by using a SPOOL add-on product (e.g. ROUTER by Océ).

The STOP-PRINTER-OUTPUT command does not terminate this forwarding. Although it is still accepted for local printers, it only has an effect on RSO printers and virtual devices.

Privileged functions:

RSO device administrators and spool and cluster administrators can cancel the assignment of any device that they manage. For more information on these user groups see the manuals “RSO” [32], “SPOOL” [43] and “Distributed Print Services” [10]. 

Format

STOP-PRINTER-OUTPUT                                                                                                                             

DEVICE-NAME = *ANY-LOCAL-PRINTER(...) / *RSO-PRINTER(...)
	*ANY-LOCAL-PRINTER(...)
		|	UNIT = list-poss(8): <alphanum-name 1..8>
		|	,STOP = *STD / *IMMEDIATE
	*RSO-PRINTER(...)
		|	NAME = list-poss(8): <alphanum-name 1..8>
		|	,STOP = *STD / *IMMEDIATE

Operands

DEVICE-NAME =
Types of printer to be disconnected.

DEVICE-NAME = *ANY-LOCAL-PRINTER(...)
For privileged users only (see “Privileges” above).
Local printers are to be disconnected.

UNIT = list-poss(8): <alphanum-name 1..8>
Mnemonic device names or device names of the local printers which are to be disconnected.

STOP = *STD / *IMMEDIATE
Specifies whether printout is to be terminated immediately or a currently active job is to be completed first.

DEVICE-NAME = *RSO-PRINTER(...)
Not for nonprivileged users other than RSO device administrators.
RSO printers are to be disconnected.

NAME = list-poss(8): <alphanum-name 1..8>
Names of the RSO printers which are to be disconnected.

STOP = *STD / *IMMEDIATE
Specifies whether printout is to be terminated immediately or a currently active job is to be completed first. 

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error Guaranteed message: SPS0B06
	1	CMD0202	Syntax error
	32	SCP0974	System error. Command rejected
	32	SRO0174	System error. Command rejected
	64	SCP0975	No authorization for command
	64	SCP0976	Invalid operand value
	64	SRO0175	No authorization for command
	64	SRO0176	Invalid operand value
	128	SCP0896	Subsystem not loaded/ready Guaranteed message: SCP0896