IPX/SPX Programming Manual

Library Routines

HP NonStop IPX/SPX Programming Manual—528022-001

5-77

sap_open

The sap_open function opens the IPXPROTO process.

is an integer file descriptor for the new communication session with the SAPs. This

is the return value. If the value of fn is less than 1, the call failed. Refer to

*pError below.

*pError

is the file system error returned if the function call fails with the value -1. Errors are

listed in the Guardian Procedure Calls Reference Manual.

nowait_depth

Refer to the FILE_OPEN_ subsection of the Guardian Procedure Calls Reference

Manual for a description of this field. Set to 1.

sync_or_receive_depth

Unsupported by NonStop IPX/SPX. Always set to 0.

options

Refer to the FILE_OPEN_ subsection of the Guardian Procedure Calls Reference

Manual for a description of this field.

C Synopsis

#include <sapapih>

short fn = sap_open

( unsigned long *pError

, short nowait_depth

, short sync_or_receive_depth

, short options );

TAL Synopsis

?SOURCE sapapid

INT fn = PROC sap_open

( pError, nowait_depth, sync_or_receive_depth

, options), LANGUAGE C;

INT(32) .EXT pError;

INT nowait_depth;

INT sync_or_receive_depth;

INT options;

EXTERNAL;