(Page 12 of 35 in this chapter)
TxX25LCNShSumm
Description
- Sets up the packet as an LCN Show Summary packet for the specified link.
Prototype
- short TxX25LCNShSumm (TXMNGPKT *req,
unsigned short index,
char *linkname )
- req Packet to be set.
- index Index indicating first LCN to return in summary list.
- linkname Pointer to link name to list of LCNs.
Return Values
- TX API completion code.
Details
- The index parameter is used to indicate what LCN should be the first returned in the response packet. This value should be zero when beginning any show summary. If the repeat flag is set on a following call to TxX25LCNShNext, the index specified by the show next function should be provided here. The response to a show summary LCN request should be handled by repeated calls to TxX25LCNShNext.
- TxX25LCNShSumm assumes that the packet is already a properly initialized management packet. Applications should call TxApiPktInit some time prior to calling TxX25LCNShSumm.
- The response to a show summary LCN request should be handled by repeated calls to TxX25LCNShNext which returns pointers to records within a summary block and tells when and which index to use for the next block
- Each response record must be broken down directly by the application, referencing the TxX25_LCN_Summ structure in X25type.h. No API assistance functions are provided for this operation except of platform-independent swap routines so the data is in the correct word/byte order for the host. It is important that applications use the proper conversion functions when referencing any response fields to ensure processor independence is maintained. All fields are returned in the TX board byte ordering (MC680x0).
See Also
- TxApiPktInit, TxX25LCNShNext
(Page 12 of 35 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.