Important: The information in this document is obsolete and should not be used for new development.
Getting Information About the .MPP Driver and the
This section describes how you can use the
Network EnvironmentPGetAppleTalkInfo
function to obtain information about the installed version of the .MPP driver, the network environment, and the .MPP driver's maximum capacities, such as the number of sockets and the number of NBP calls that the .MPP driver supports. The .MPP driver implements
these protocols:
Before you call the
- Datagram Delivery Protocol (DDP)
- Routing Table Maintenance Protocol (RTMP) stub
- Name-Binding Protocol (NBP)
- AppleTalk Echo Protocol (AEP)
PGetAppleTalkInf
o function, you must allocate memory for and define a parameter block of typeMPPParmType
. The section "MPP Parameter Block" beginning on page 2-9 shows this data structure. You must also allocate memory for and provide pointers to the data buffers into which thePGetAppleTalkInfo
function returns the data-link address and zone name for extended networks.The
PGetAppleTalkInfo
function's Boolean parameter allows you to specify whether the function is to be executed synchronously or asynchronously. This function is generally executed synchronously. (For information on these two modes, see the chapter "Introduction to AppleTalk" in this book.)The
PGetAppleTalkInfo
function returns the following information:
The data-link address and the zone name are returned only for extended networks--that is, network types that allow more than one network number per network. You use the
- a pointer to the MPP global variables
- a pointer to the .MPP driver's device control entry (DCE) data structure
- configuration flags that indicate the status of certain conditions that are set at startup
- a value (the
selfSend
flag) that indicates whether the node can send packets to itself (See "Sending Packets to Applications and Processes on Your Own Node" on page 2-6 and "Enabling Intranode Delivery of DDP Packets" on page 2-15 for more information.)- the range of network numbers for the network to which the node is attached
- the 8-bit node ID and 16-bit network number of the node
- the 8-bit node ID and 16-bit network number of the last router from which the node has heard
- the maximum capacities of the .MPP driver, such as the maximum number of protocol handlers and the maximum number of static sockets allowed by this driver
- a pointer to the registered names queue
- the address of the node on the underlying data link (for example, the Ethernet hardware address)
- the node's zone name
laLength
parameter to specify the length of the data-link address you want returned; the function returns the actual length of the data in thelaLength
parameter and returns the data in the buffer you provide.The
ExtendedBit
flag returned by thePGetAppleTalkInfo
function isTRUE
if the node is connected to an extended AppleTalk network. (TheExtendedBit
flag is bit 15 of the configuration parameter returned by this function.) Note that the presence of
the AppleTalk Phase 2 drivers does not of itself indicate that the node is connected to
an extended network. For more information, see "PGetAppleTalkInfo" beginning on page 2-11.
- Note
- Always use the
PGetAppleTalkInfo
function to obtain information about the .MPP driver. You cannot rely on the validity of the MPP global variables pointed to by thevarsPtr
parameter block field value for this information.