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

AIFPORTCLOSE
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Removes a connection to a port opened by a call to AIFPORTOPEN.

Syntax

                    REC        I32       I32

AIFPORTCLOSE (overall_status, port_id, access_mode);

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_id

32-bit signed integer by reference (required)

The port ID of the port to close (the identifier returned from a successful call to AIFPORTOPEN).

access_mode

32-bit signed integer by value (optional)

Individual access modes may be closed separately. This parameter specifies the mode to close with this call to AIFPORTCLOSE. The access need not be the same as used in the AIFPORTOPEN. If the calling process does not have the port open for the specified access, the close is ignored for that access. If not passed, the port is closed for all access modes. Values and their meanings are as follows:

1

Receive access

2

Send access

3

Both receive and send access

Default: all access modes

Operation Notes

For every AIFPORTOPEN performed during the life of a process, a corresponding AIFPORTCLOSE should be performed. In the event of a process abort, or if the process neglects to call AIFPORTCLOSE for any or all of the ports it has open, the ports are closed automatically during the process termination sequence. If the port is not specified to be a permanent port by the last process to open the port, it is destroyed when the last opener closes the port. If the port is a permanent port, it remains after the last process closes it.

Asynchronous ports are always temporary and have only a single receiver (the creator); therefore, when the creating process terminates or calls AIFPORTCLOSE with receive access, subsequent sends to the port return an error since the receiver no longer exists. See "Operation Notes" on AIFPORTOPEN for more details on asynchronous ports.



AIFMOMOUNT
  		 


AIFPORTINT  
Feedback to webmaster