HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Architected Interface Facility: Operating System Reference Manual > Chapter 3 Architected Interface Descriptions

AIFSPPRESUME

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 and SPOOLER dev;RESUME.

Feedback to webmaster