|
|
|
Resumes a suspended spooling process.
Syntax
REC REC I32 I32
AIFSPPRESUME ( overall_status, spooler_device, direction, offset,
I32 I32
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 resumed. 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.)
- direction
- 32-bit signed integer by value (optional)
Passes a value that tells the spooler how to apply the
offset parameter. See also the explanation of the
offset parameter for relative and absolute offsets. The
valid inputs and their meanings are as follows:
| 0 | Relative offset specified in the
offset parameter (default) |
| 1 | Absolute offset specified in the
offset parameter |
Default: 0
- offset
- 32-bit signed integer by value (optional)
Passes a value representing a page offset, either absolute or relative,
within the spool file. Together with the direction
parameter, it tells the spooler where to resume when the file is picked
up again for printing.
If absolute is specified in direction, printing resumes
at that page, absolute from the beginning of the file. If relative is
specified in direction, then depending on whether
offset is positive or negative, the offset is adjusted
either forward or backward relative to the current location, by the
number of pages specified.
No matter which combination of offsets is specified, the final location
is limited by the bounds of the file. The default for offset is 0. If
the printing of a spool file is to be resumed from the beginning of the
file, pass absolute for direction and 0 for
offset.
Default: 0
- q_state
- 32-bit signed integer by reference (optional)
Passes a value that indicates whether the spooling queue is to be opened
or disabled when the spooling process is resumed. The default is not to
change the current q_state of the spooler process. The
valid inputs and their meanings are as follows:
| 0 | No change to the current q_state
of the spooling process (default) |
| 1 | Openq |
| 2 | Shutq |
Default: 0
- 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
The spooler must be in the suspend state. If the spooler retained a spool file
when it was suspended and the spool file was not subsequently released, the
offset parameter can be specified. If it is not specified,
output resumes where it was left off. AIFSPPRESUME is the
programmatic interface for executing the commands:
RESUMESPOOL
SPOOLER dev;RESUME
|
