|
|
|
Terminates spooling to the specified logical device number, device name, or
device class. The spooling processes associated with the devices are also
terminated.
Syntax
REC REC I32 I32
AIFSPPSTOP ( overall_status, spooler_device, finish, q_state,
I32
user_id );
Parameters
- overall_status
- record by reference (required)
Returns the overall status of the call. A zero indicates a successful
call. A negative value indicates an error in the overall call. A
positive value indicates a warning. Refer to appendix A for meanings of
status values.
Record type: status_type (Refer to appendix B.)
- spooler_device
- record by reference (required)
Passes the device name, LDEV number, or device class for which the
spooling process is to be terminated. An LDEV number must be converted
into an ASCII character string before being passed to this routine. The
name should be left-justified and padded with blanks.
Array type: device_name_type (Refer to appendix B.)
- finish
- 32-bit signed integer by value (optional)
Passes the finishing strategy for stopping the spooling process. The
valid inputs and their meanings are as follows:
| 1 | Finish now (default) |
| 2 | Finish at end of copy |
Default: 1
- q_state
- 32-bit signed integer by reference (optional)
Passes a value that indicates whether the spooling queue is to remain
open or disabled when the spooling process terminates. The default is
Shutq for terminating a spooler process. If Openq is specified, it
allows users to generate spool files on that device even when the
spooling process has been terminated. The valid inputs and their
meanings are as follows:
| 0 | No change to the current q_state
of the spooling process |
| 1 | Openq |
| 2 | Shutq (default) |
Default: nil
- user_id
- 32-bit signed integer by value (optional)
The user ID assigned to a vendor at the time of purchase of the
Architected Interface Facility: Operating System product. If it is not
passed, the caller must have previously called AIFACCESSON.
Default: 0
Operation Notes
A Shutq is done by default when AIFSPPSTOP is invoked, unless the
q_state parameter specifies Openq. AIFSPPSTOP is the
programmatic interface for executing the commands:
STOPSPOOL
SPOOLER dev;STOP
|
