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

AIFPORTINT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Allows the user to change the interrupt handler state of one or more asynchronous ports. The caller of this routine must be the receiver of the port.

Syntax

                 REC          I32A       BA        BA

AIFPORTINT (overall_status, port_list, newstates, oldstates);

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.)

port_list

32-bit signed integer array by reference (required)

Passes an array of integers that contain a list of port IDs whose handlers will be enabled or disabled. This array MUST be terminated with a zero. Each port ID must be an asynchronous port that has been created by the caller. If any port ID is invalid, then NONE of the ports will have their interrupt state changed.

newstates

Boolean array by reference (required)

An array of Booleans that specify the new port interrupt handling states that are the result of this call. A value of TRUE enables interrupt handling for the corresponding port ID in the port_list, while FALSE disables interrupt handling on a port. This array must contain as many elements as are contained in port_list.

oldstates

Boolean array by reference (optional)

An array of booleans, that upon return from a successful call contains a value of TRUE for each port in port_list that had interrupts enabled prior to this call, and FALSE for each port that had interrupts disabled. This array must contain as many elements as are contained in port_list. If the call fails because of an invalid port ID and this array was passed, a value of FALSE is returned for each port that was not previously created by the caller.

Default: nil

Operation Notes

The AIFPORTINT routine has been provided to allow a user to enable or disable interrupt handling when a message arrives on an AIF port. When interrupt handling is disabled on a port, calls to the interrupt handling routine are delayed until interrupt handling is reenabled with the AIFPORTINT routine.

Feedback to webmaster