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

AIFSPPRELEASE

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Releases the spool file that is currently kept by the specified suspended spooler.

Syntax

                     REC            REC        I32    I32

AIFSPPRELEASE (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 that is currently keeping a spool file due to an earlier SUSPEND with the KEEP option. 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 absolute and relative offsets. The valid inputs and their meanings are as follows:

0

Relative offset specified in the offset parameter

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 indicating 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

AIFSPPRELEASE closes the spool file and returns it to the ready state. An offset may be specified to change the resumption point of the spool file the next time it is selected for printing. AIFSPPRELEASE is the programmatic interface for executing the command SPOOLER dev;RELEASE.

Feedback to webmaster