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

AIFSPPSTOP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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     I32

AIFSPPSTOP (overall_status, spooler_device, finish, 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 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 and SPOOLER dev;STOP.

Feedback to webmaster