(Page 28 of 35 in this chapter)
TxX25LinkShSumm
Description
- Sets up the packet as an link Show Summary (I/O Info) packet for the specified link.
Prototype
- short TxX25LinkShSumm (TXMNGPKT *req,
unsigned short index)
- req Pointer to packet to be set.
- index Index indicating first link to return in the summary list.
Return Values
- TX API completion code.
Details
- The index parameter is used to indicate what link 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 TxX25LinkShNext, the index specified by the Show Next function should be provided here.
Note: TxX25LinkShSumm assumes that the packet is already a properly initialized management packet. Applications should call TxApiPktInit some time prior to calling TxX25LinkShSumm.
- The response to a show summary link request should be handled by repeated calls to TxX25LinkShNext 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_LnkShSumm structure in X25type.h. No API assistance functions are provided for this operation. 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, TxX25LinkShNext
(Page 28 of 35 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.