IPX/SPX Programming Manual

Library Routines
HP NonStop IPX/SPX Programming Manual—528022-001
5-69
SAP Description
SAP Table Entries
Each SAP table entry contains the following information:
Clients can query the SAP tables for available services and obtain the addresses of the
servers that are offering those services. A client might look for a specific server or for
all servers of the same type.
sap_stop or sap_stop_nw Deletes an entry from the SAP table in the IPXPROTO
process.
sap_info or sap_info_nw Returns 0 or more SAP entries from the SAP table in the
IPXPROTO process. You might have to execute this call
more than once to read the entire SAP table if it is too large
to fit into the sap_info buffer.
sap_close Terminates a session between an application and the
IPXPROTO process for SAP. Any services initially
advertised in this session are no longer advertised.
Server Name
*
a string of up to 48 characters. The server name must be
unique within the entire NetWare internetwork.
Server Type a unique number assigned to a class of servers, such as the
NetWare file server class, various print server classes, and
so on. HP has reserved a range of server-type numbers for
NonStop services such as Telserv and ODBC servers.
Table 5-4
lists the NonStop server types.
IPX Address the IPX address of the server.
Hops to Server the number of routers that must be passed to reach the
server.
Time Since Changed removes entries for a server that started but has
subsequently stopped advertising.
*For NonStop server applications, HP recommends that the NonStop system name and the Guardian process
name be used for the server name, for example,
SYSNAM.$ODBC1. This convention ensures that the server
name is unique in the NetWare internetwork.
Table 5-4. Server Type Numbers
Server Type Number (Hexadecimal) Service
0x0474 ODBC Server
0x05C7 Telserv Server
0x05C9 - 0x05D0 Reserved for HP use
0x05D1 - 0x05D2 Reserved for RSC and HP customer use
Function Call Purpose