|
|
|
Creates and activates a new spooler process to handle spool files destined for
the specified logical device number, device name, or device class.
Syntax
REC REC I32 I32
AIFSPPSTART ( overall_status, spooler_device, q_state, 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 logical device number (LDEV), device name, or device class
for which the spooling process is to be initiated. 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.)
- q_state
- 32-bit signed integer by reference (optional)
Passes a value used to indicate whether the spooling queue is to be
enabled or disabled when the spooler process is initiated. The default
is Openq for starting a spooler process. If Shutq is specified, it
prevents users from generating spool files for that device. It does not
prevent the user from printing previously generated spool files. The
valid inputs and their meanings are as follows:
| 0 | No change to the current q_state
of the spooling process |
| 1 | Openq (default) |
| 2 | Shutq |
Default: 1
- 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
An Openq is done by default when AIFSPPSTART is invoked, unless the
q_state parameter specifies Shutq. AIFSPPSTART is the
programmatic interface for executing the commands:
STARTSPOOL
SPOOLER dev;START
|